home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmeClearBorder.z / XmeClearBorder
Text File  |  1998-10-30  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmeeeeCCCClllleeeeaaaarrrrBBBBoooorrrrddddeeeerrrr((((3333XXXX))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV        XXXXmmmmeeeeCCCClllleeeeaaaarrrrBBBBoooorrrrddddeeeerrrr((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmeeeeCCCClllleeeeaaaarrrrBBBBoooorrrrddddeeeerrrr - Clears the window decorations that border a
  10.           given widget
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/DrawP.h>
  14.           vvvvooooiiiidddd XXXXmmmmeeeeCCCClllleeeeaaaarrrrBBBBoooorrrrddddeeeerrrr(
  15.           DDDDiiiissssppppllllaaaayyyy ****ddddiiiissssppppllllaaaayyyy,
  16.           WWWWiiiinnnnddddoooowwww wwwwiiiinnnnddddoooowwww,
  17.           PPPPoooossssiiiittttiiiioooonnnn xxxx,
  18.           PPPPoooossssiiiittttiiiioooonnnn yyyy,
  19.           DDDDiiiimmmmeeeennnnssssiiiioooonnnn wwwwiiiiddddtttthhhh,
  20.           DDDDiiiimmmmeeeennnnssssiiiioooonnnn hhhheeeeiiiigggghhhhtttt,
  21.           DDDDiiiimmmmeeeennnnssssiiiioooonnnn tttthhhhiiiicccckkkknnnneeeessssssss);
  22.  
  23.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  24.           This page documents Motif 2.1.
  25.  
  26.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.           XXXXmmmmeeeeCCCClllleeeeaaaarrrrBBBBoooorrrrddddeeeerrrr clears the border highlight and/or shadows
  28.           bordering a rectangular widget. To clear these window
  29.           decorations, XXXXmmmmeeeeCCCClllleeeeaaaarrrrBBBBoooorrrrddddeeeerrrr paints them in the widget's
  30.           background color.
  31.  
  32.           The border highlight surrounds the perimeter of a widget.
  33.           When calling XXXXmmmmeeeeCCCClllleeeeaaaarrrrBBBBoooorrrrddddeeeerrrr to clear the border highlight,
  34.           your widget should do the following:
  35.  
  36.              +o  Set _x and _y to 0.
  37.  
  38.              +o  Set _w_i_d_t_h and _h_e_i_g_h_t to the width and height of
  39.                 _w_i_n_d_o_w.
  40.  
  41.              +o  Set _t_h_i_c_k_n_e_s_s to the highlight thickness.  (If you are
  42.                 subclassing a primitive widget, then the highlight
  43.                 thickness is stored in the field
  44.                 pppprrrriiiimmmmiiiittttiiiivvvveeee....hhhhiiiigggghhhhlllliiiigggghhhhtttt____tttthhhhiiiicccckkkknnnneeeessssssss.)
  45.  
  46.           The widget's shadows lie within the border highlights.  When
  47.           calling XXXXmmmmeeeeCCCClllleeeeaaaarrrrBBBBoooorrrrddddeeeerrrr to clear the shadows, your widget
  48.           should do the following:
  49.  
  50.              +o  Set _x and _y to the highlight thickness.
  51.  
  52.              +o  Set _w_i_d_t_h so that it equals the width of the window
  53.                 minus twice the highlight thickness.
  54.  
  55.              +o  Set _h_e_i_g_h_t so that it equals the height of the window
  56.                 minus twice the highlight thickness.
  57.  
  58.              +o  Set _t_h_i_c_k_n_e_s_s to the shadow thickness of the widget.
  59.                 (If you are subclassing a primitive widget, the shadow
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmeeeeCCCClllleeeeaaaarrrrBBBBoooorrrrddddeeeerrrr((((3333XXXX))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV        XXXXmmmmeeeeCCCClllleeeeaaaarrrrBBBBoooorrrrddddeeeerrrr((((3333XXXX))))
  71.  
  72.  
  73.  
  74.                 thickness is stored in the field
  75.                 pppprrrriiiimmmmiiiittttiiiivvvveeee....sssshhhhaaaaddddoooowwww____tttthhhhiiiicccckkkknnnneeeessssssss.)
  76.  
  77.           _d_i_s_p_l_a_y   Specifies the display on which _w_i_n_d_o_w is rendered.
  78.  
  79.           _w_i_n_d_o_w    Specifies the window whose decorations are to be
  80.                     erased.
  81.  
  82.           _x         Specifies the x-coordinate in pixels of the left
  83.                     edge of whatever decoration is to be cleared.
  84.  
  85.           _y         Specifies the y-coordinate in pixels of the top
  86.                     edge of whatever decoration is to be cleared.
  87.  
  88.           _w_i_d_t_h     Specifies the width in pixels of the top edge of
  89.                     whatever decoration is to be cleared.
  90.  
  91.           _h_e_i_g_h_t    Specifies the height in pixels of the left edge of
  92.                     whatever decoration is to be cleared.
  93.  
  94.           _t_h_i_c_k_n_e_s_s Specifies the thickness in pixels of whatever
  95.                     decoration is to be cleared.
  96.  
  97.      RRRREEEELLLLAAAATTTTEEEEDDDD
  98.           XXXXmmmmeeeeDDDDrrrraaaawwwwSSSShhhhaaaaddddoooowwwwssss(3) and XXXXmmmmeeeeDDDDrrrraaaawwwwHHHHiiiigggghhhhlllliiiigggghhhhtttt(3).
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.